home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 005 / tsrcom16.arc / TSR.DOC < prev   
Encoding:
Text File  |  1986-03-20  |  5.1 KB  |  114 lines

  1. **********************************************************************
  2.  
  3.   The TSR package is a group of programs useful in managing
  4.   DOS memory, and in particular managing memory-resident
  5.   utilities. TSR stands for "Terminate and Stay Resident".
  6.  
  7. **********************************************************************
  8.  
  9. MARK.COM and RELEASE.COM are used to remove memory-resident
  10. programs from memory, without the usual problems of creating
  11. holes or leaving interrupts dangling. The two programs are used
  12. simply as follows:
  13.  
  14. 1) Run the program MARK.COM before installing any memory-
  15.    resident program that you may wish to deinstall later.
  16.    This marks the current position in memory and stores the
  17.    DOS interrupt vector table (all interrupts from 0 to FFH).
  18.  
  19. 2) Install whatever TSRs that you want to use, in the normal
  20.    way that you install them.
  21.  
  22. 3) When you want to deinstall all TSRs above the last MARK,
  23.    run the program RELEASE.COM. This will release all of the
  24.    memory above (and including) the last MARK, and restore
  25.    all interrupt vectors taken over by the memory resident
  26.    programs.
  27.  
  28. MARK and RELEASE can be "stacked" as many times as desired.
  29. RELEASE releases the memory above the last MARK call.
  30. MARK uses about 1600 bytes of memory each time it is called.
  31. This 1600 byte region is also released when a RELEASE is done.
  32. MARK memory usage is dominated by the copies of the DOS
  33. interrupt vector table (interrupts 0..FFH) and the copy
  34. of the EMS page map (blocks 0..31 only) which MARK keeps
  35. when it goes resident.
  36.  
  37. MARK and RELEASE can optionally be called with a single command
  38. line parameter:
  39.  
  40.   MARK MarkName
  41.   RELEASE MarkName
  42.  
  43. In this way a particular mark is given a name. Calling RELEASE
  44. with the same name will release all memory above and including
  45. the mark of that name, also releasing any intermediate marks in
  46. the process. If no mark of the proper name is found, RELEASE will
  47. halt with a warning. A RELEASE call with no MarkName specified
  48. will release the last MARK, whether or not that MARK was named.
  49.  
  50. The MarkName can be any text string up to 126 characters in length.
  51. It may not contain embedded blanks or tabs. Case (upper or lower)
  52. is not important when matching MarkNames.
  53.  
  54. As of version 1.4, MARK and RELEASE also control Expanded memory
  55. (Lotus/Intel/Microsoft EMS). They have been tested with READY!
  56. and with the TurboPower Software expanded memory disk cache, as
  57. well as with the device drivers used by the STB Expanded Memory
  58. Card.
  59.  
  60. WARNING: if a resident application allocates expanded memory
  61. at some time >after< going resident and after the last MARK made,
  62. that expanded memory will be released by a call to RELEASE.
  63. The current expanded memory manager (EMM) does not give us enough
  64. information to avoid this possibility. Fortunately, there are
  65. no known memory resident programs which perform this dynamic
  66. allocation of expanded memory. We hope that the EMM will be
  67. upgraded before such applications are designed.
  68.  
  69. As of version 1.6, RELEASE takes special precautions to allow
  70. it to release extra invocations of the DOS command processor.
  71. In the simplest form, an extra command processor is obtained
  72. by typing COMMAND at the DOS level. Many multitasking or
  73. switching utilities also utilize this feature of DOS, and these
  74. utilities can now be managed via MARK and RELEASE.
  75.  
  76. **********************************************************************
  77.  
  78. MAPMEM.COM is used to display the current DOS memory map. It shows
  79. the resident programs, how much memory they use, and what interrupt
  80. vectors each currently owns. MAPMEM also shows information about
  81. expanded memory when such a card is installed. Calling MAPMEM with
  82. a "V" command line parameter (i.e., MAPMEM V) will show additional
  83. information about each program . The "Files" column shows the number
  84. of file handles that each resident program has kept open.
  85.  
  86. RAMFREE.COM supplies a quick way to determine the amount of free RAM
  87. (without going through CHKDSK).
  88.  
  89. EATMEM.COM is useful for development work where you want to test
  90. software in an environment with a desired amount of available memory.
  91. Note that the memory used by EATMEM can be freed up by using MARK
  92. and RELEASE. EATMEM is called with a single command line parameter,
  93. specifying (in decimal) the number of KILOBYTES to eat up.
  94.  
  95. **********************************************************************
  96.  
  97. All of these programs should work on any system running PCDOS or
  98. MSDOS 2.0 or later. They were developed on a Compaq Deskpro
  99. 286 running Compaq DOS 3.0. Source code is available in the file
  100. TSRSRC.ARC (the programs are written in assembly language (CHASM)
  101. and Pascal (Turbo)).
  102.  
  103. Written by Kim Kokkonen, TurboPower Software.
  104. Version 1.6 - 3/20/86.
  105. Telephone: 408-378-3672 (M-F 9AM-5PM only)
  106. Compuserve: 72457,2131
  107.  
  108. The programs have been released to the public domain for personal,
  109. non-commercial use only. You may use them yourself, give them to
  110. your friends or co-workers, or distribute them for a cost-based
  111. fee as part of a user's group or bulletin board service. If you
  112. wish to distribute these programs as part of a commercial package,
  113. please contact us for a license agreement.
  114.